home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / AMICUS / AMICUS12.ADF / PopCLI / PopCLI.DOC < prev    next >
Text File  |  1986-08-05  |  5KB  |  85 lines
  1. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  2. /* |_o_o|\\ Copyright (c) 1986 The Software Distillery.  All Rights Reserved */
  3. /* |. o.| || This program may not be distributed without the permission of   */
  4. /* | .  | || the authors.                                                    */
  5. /* | o  | ||    Dave Baker     Ed Burnette  Stan Chow    Jay Denebeim        */
  6. /* |  . |//     Gordon Keener  Jack Rouse   John Toebes  Doug Walker         */
  7. /* ======          BBS:(919)-471-6436      VOICE:(919)-469-4210              */ 
  8. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  9.  
  10. POPCLI by John Toebes ⌐ 1986 The Software Distillery.  All Rights Reserved
  11.  235 Trillingham Ln, Cary, NC 27511
  12.  
  13. Permission is hereby granted to distribute this program provided both this
  14. documentation accompanies the executable and that no charge is made for its
  15. distribution.
  16.  
  17. POPCLI is designed to solve two problems at once.  First it provides a simple
  18. way of starting another CLI at any time without having to load workbench or
  19. exit whatever program you may be using.  Second it has a builtin screen saver
  20. mode that automatically turns off the Amiga display when there has been no
  21. input for a given period of time.
  22.  
  23. Once POPCLI is running, you can use it to get a new CLI from whatever program
  24. you are running by pressing Left Amiga and ESC at the same time.  What this
  25. does is to bring the workbench screen to the front and then start up a new
  26. CLI window on the workbench screen.  This is extremely handy when you start
  27. a program from CLI and then find you need to do a CLI command.
  28.  
  29. The other function that POPCLI performs is to blank the screen for you.  This
  30. saves on the wear of the monitor phospher.  It will do this for you
  31. automatically any time that you have not pressed any key or moved the mouse
  32. for a given period of time regardless of what has been written to the screen.
  33. This is useful when you leave the Amiga on unattended so that you don't have
  34. to mess with the brightness control or worse yet tunr the monitor off putting
  35. wear and tear on its power supply.  Furthermore it only takes a touch of the
  36. mouse or any key on the keyboard to bring it all back.
  37.  
  38. To use POPCLI, you need to execute the command:
  39.   RUN POPCLI <seconds> <command>
  40.  
  41. Where <seconds> is any number of seconds after which the screen saver is to
  42. go into effect.  If nothing is specified it defaults to turning off the
  43. screen after 120 seconds. (Two minutes)  Note that it makes its decision to
  44. shut blank the screen solely upon the absence of any keyboard, gameport, or
  45. mouse input.  Even if a program is printing to the screen it will shut down.
  46. This is not a problem, to unblank the screen merely move the mouse or touch any
  47. key (SHIFT or CTRL are excellent choices since they don't do anything).
  48.  
  49. <command> is the command to be executed when the Left Amiga and ESC keys are
  50. pressed simaultaneously.  By default the command is
  51.    NEWCLI >NIL:
  52. to bring up a CLI window in the center of the screen.  Note the >NIL: on the
  53. command to supress any output that the NEWCLI program may give.  This is
  54. important because at the time the command is executed, the original window
  55. may be long gone.  If you wish to have a CLI come up elsewhere on the screen
  56. you can put the window definition in the command such as:
  57.    NEWCLI >NIL: CON:0/0/640/200/MYCLI
  58. Which will open a CLI to fill the entire screen.  POPCLI does no parsing on
  59. the command, merely passing the ENTIRE string without any processing to
  60. AmigaDOS.
  61.  
  62. If you wish to specify a command with POPCLI you must include the seconds
  63. value followed by one or more spaces.  Some valid commands are:
  64.    RUN POPCLI 200
  65.    RUN POPCLI 200 NEWCLI >NIL: CON:0/0/640/100/MYWINDOW
  66.    RUN POPCLI 10
  67.    RUN POPCLI 180 NEWCLI >NUL: CON:0/10/640/120/POPUP
  68.  
  69. To install a copy of POPCLI on your workbench, put a copy of POPCLI in your
  70. C directory and edit the Startup-Sequence file in the S directory to add
  71. a RUN POPCLI command of your own taste.
  72.  
  73. Notes:
  74. 1) Once POPCLI is installed, the only way to get rid of it is to reboot.
  75. 2) POPCLI blanks the screen by creating a one bit-blane lo-res screen in front
  76.    of all other screens and setting the background color to solid black.  It
  77.    then turns off the display freeing the cycles for any program that might
  78.    be running.
  79. 3) Once the screen blanks, if the AMIGA is left undisturbed for 68.096 years
  80.    the screen may briefly flash back on for the next 68.096 years.  I have not
  81.    taken the time to test this.  If this turns out to be a problem, please
  82.    let me know.
  83. 4) As with all RUN commands, the original CLI window may refuse to go away
  84.    despite typing in an ENDCLI.
  85.